home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Toolkit / Multimedia Toolkit.iso / tools / pkz110.exe / ADDENDUM.DOC next >
Text File  |  1990-03-15  |  21KB  |  561 lines
  1.  
  2.  
  3.      PKZIP, PKUNZIP and PKSFX Version 1.1 includes several new features.
  4.      They are described in this addendum to the PKZIP, PKUNZIP and PKSFX
  5.      Version 1.0 manual.
  6.  
  7.  
  8.      PKZIP
  9.  
  10.      The following new features have been incorporated into the PKZIP
  11.      Version 1.1 software release.
  12.  
  13.      -3  Disable 80386 instruction usage
  14.      -----------------------------------
  15.  
  16.           This option is available for users with 80386 type computers.
  17.           It is used to turn OFF the added 80386 instructions or
  18.           registers.  When these instructions are available, PKZIP will
  19.           utilize them to allow the program to function even faster.
  20.           However, if you are running a different program that may
  21.           conflict with use of the 80386 instructions, you can disable
  22.           them by using this command.
  23.  
  24.           The 80386 instructions will be disabled only for the current
  25.           PKZIP operation.  They will then be enabled immediately after
  26.           the command operation is completed.
  27.  
  28.           C:\PKWARE> PKZIP FILES.ZIP  -3   -a  *.DOC
  29.  
  30.           In the above example,  all of the *.DOC files in the current
  31.           directory will be added to the ZIP file, FILES.ZIP.  The 80386
  32.           instructions will be disabled while the command is being
  33.           executed.
  34.  
  35.  
  36.           You can also disable the 80386 instructions when you start
  37.           PKZIP by using the PKNO386 environment variable.  To set the
  38.           environment variable, type PKNO386=xxxx, where "xxxx" is any
  39.           string you choose.  If the string PKNO386 is present in the
  40.           environment, then PKZIP (and PKUNZIP) will not use the 80386
  41.           instructions or registers.
  42.  
  43.           To enable the 80386 instructions after they have been
  44.           disabled, type SET PKNO386=<Enter>, where <Enter> refers to
  45.           the Enter key.
  46.  
  47.  
  48.           NOTE:  Disabling the 80386 usage will make PKZIP run up to
  49.                  twenty percent slower than if the 80386 instructions
  50.                  are used.
  51.  
  52.  
  53.  
  54.  
  55.      PKWARE Version 1.1  Addendum         1
  56.  
  57.  
  58.  
  59.      -^  Echo the command line
  60.      -------------------------
  61.  
  62.           This command is used to display the PKZIP command that you
  63.           entered on the console.  It is useful for example, when you
  64.           are using the View file option; the file specifications that
  65.           you entered will be echoed on the console along with the
  66.           command output.
  67.  
  68.           E:\> PKZIP  docs.zip  -vd -^ *.doc
  69.  
  70.           In this example, technical information about all of the *.doc
  71.           files included in the DOCS.ZIP  ZIP file will be displayed.
  72.           The information will be sorted by date, and the command line
  73.           will be redisplayed on the screen above the output.
  74.  
  75.  
  76.      -x@file  Exclude list file
  77.      --------------------------
  78.  
  79.           This option is used to exclude a List File from the current
  80.           operation.  Recall that a List File is a file containing a
  81.           list of files that are grouped together.  List Files can be
  82.           used with all the PKZIP and PKUNZIP command options.  They are
  83.           always preceded by the @ symbol on the command line.
  84.  
  85.           This command can be useful when you want to exclude a few
  86.           files from an operation and the DOS wild cards cannot be used
  87.           effectively.
  88.  
  89.           C:\ACTNG> PKZIP STORE  *.* -x@ACCOUNTS.LIS
  90.  
  91.           In the above example, all of the files in the current
  92.           directory, except for the List File, ACCOUNTS.LIS, will be
  93.           compressed into the ZIP file STORE.ZIP.
  94.  
  95.  
  96.      -$[d]   Save volume label
  97.      -------------------------
  98.  
  99.           This command is used to save the volume label of a specific
  100.           drive along with the ZIP file.  The default drive is the
  101.           current drive, unless another is specified.  The drive letter
  102.           is not saved in the ZIP file, only the volume label.
  103.  
  104.           C:\ACCTNG> PKZIP  FILES.TAX  -a -$  *.*
  105.  
  106.           In the above example, all of the files in the current directory
  107.           will be compressed into the ZIP file, FILES.TAX. They will be
  108.           stored along with the volume label for the C: drive.
  109.  
  110.  
  111.      PKWARE Version 1.1  Addendum         2
  112.  
  113.  
  114.  
  115.      -t  ZIP only files with a date equal to or later than specified
  116.      ---------------------------------------------------------------
  117.  
  118.           With this option, you can specify a date so that only files
  119.           with a date that is equal to or more recent than the date
  120.           specified will be included in the PKZIP operation.  If no date
  121.           is specified, today's date will be used by default.
  122.  
  123.           When specifying a date, use six digits in the following
  124.           format:  mmddyy.  For example, February 14, l990 will be
  125.           listed:  -t021490.  This is true for all computers setup as
  126.           American.  If your computer is setup as European, use the
  127.           following format: ddmmyy.  If your computer is setup as
  128.           Japanese, use the following format:  yymmdd.  If you are not
  129.           sure how your computer is setup, consult your user's manual.
  130.  
  131.           C:\BACKUP> PKZIP BAKS.ZIP  -t010190
  132.  
  133.           In this example, all files in the current directory with a
  134.           date later than or equal to January 1, l990 will be compressed
  135.           into the ZIP file, BAKS.ZIP.
  136.  
  137.  
  138.      -ei   Implode files only
  139.      ------------------------
  140.  
  141.           This option is used along with the mini-PKSFX program,
  142.           PKSFXjr.  Only files that have been imploded can be extracted
  143.           with PKSFXjr.  Shrunk files cannot be extracted.  In order to
  144.           create a PKSFXjr.EXE file, this option must be used.
  145.  
  146.           E:\BATS> PKZIP  EXT.ZIP  -ei
  147.  
  148.           In this example, all of the files in the current directory
  149.           will be compressed into the ZIP file, EXT.ZIP.  All of the
  150.           files will be imploded.
  151.  
  152.  
  153.      PKZIP Configuration File
  154.      ------------------------
  155.  
  156.           The PKZIP Configuration file can be used to set parameters to
  157.           values other than the normal default values.  There are three
  158.           additional Configuration file options available.  They are
  159.           explained on the following page.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.      PKWARE Version 1.1  Addendum         3
  168.  
  169.  
  170.  
  171.           SHRINK > nnnnn
  172.           Where nnnn is some number specifying that files that are
  173.           greater than this number are to be Shrunk.  This option is
  174.           used to save time when you are compressing large files.
  175.           Typically, large files take longer to compress when the
  176.           imploding method is used.
  177.  
  178.           LISTCHAR=
  179.           This option is used to designate a special character to be used
  180.           to indicate a List file.  By default the  @ character is used,
  181.           as in @FILE.  If you want to use  @ as the first character in a
  182.           file name, you can designate an alternate character to be used
  183.           to indicate List files.  For example, you could use the # or
  184.           the % characters.
  185.  
  186.           OPTIONCHAR=
  187.           This option is used to designate a special character to be
  188.           used to indicate a command on the command line.  By default,
  189.           the minus sign  - is used.  If you want to use the minus sign
  190.           as the first character in a file name, you can designate an
  191.           alternate character to be used to indicate a command.  For
  192.           example, you could use the / character.
  193.  
  194.  
  195.           Also, PKZIP 1.1 will now search for the Configuration file in
  196.           the following order:
  197.  
  198.           1.  In the current directory.
  199.           2.  In the path specified by the PKZIP.CFG=  environment
  200.               variable.
  201.           3.  In the path where PKZIP was started from, if DOS version
  202.               greater than or equal to 3.x is being used.
  203.  
  204.  
  205.      Additional Error Code
  206.      ---------------------
  207.  
  208.           There is an additional error code available with PKZIP version
  209.           1.1.  PKZIP will exit with an errorlevel of 18 when it is
  210.           unable to open one or more specified files.  It should be noted
  211.           that this is a "warning" condition only,  and otherwise PKZIP
  212.           was able to construct the ZIP file without any errors.
  213.  
  214.  
  215.      NOTE:  There is no longer a 3900 file limit with PKZIP.  The total
  216.             number of files that can be processed is limited only by the
  217.             memory available in the system you are using.  Approximately
  218.             8000 files can be compressed in a ZIP file with 500K+ of
  219.             memory free.
  220.  
  221.  
  222.  
  223.      PKWARE Version 1.1  Addendum         4
  224.  
  225.  
  226.  
  227.      Authenticity Verification
  228.      -------------------------
  229.  
  230.       -!  Encrypt authenticity verifiable data into the .ZIP file.
  231.  
  232.           This feature allows you to create ZIP files that PKUNZIP or
  233.           PKSFX can test for authenticity while extracting, providing for
  234.           detection of tampered, hacked, or virus infected files.
  235.  
  236.           To use this feature, you need to be a registered user of the
  237.           software, and mail the form AUTHVERI.FRM to PKWARE.  PKWARE
  238.           will then send you a postcard listing your name or the name of
  239.           your company, and a unique serial number.
  240.  
  241.           You must then use the PUTAV.EXE program included with the
  242.           PKWARE program files to install this information.  To do this,
  243.           use the following steps.
  244.  
  245.           Step 1.  Type PUTAV.  Make sure that PKZIP.EXE is also in the
  246.                    current directory when you do this.  The program will
  247.                    then prompt you to enter your company name.
  248.  
  249.           Step 2.  Enter your name or the name of the company the
  250.                    software is registered to.  Enter it the same as it
  251.                    appears on the postcard that PKWARE sent.  Press the
  252.                    Enter key when you are done.
  253.  
  254.           Step 3.  Enter the serial number at the prompt.  Then press
  255.                    the Enter key.
  256.  
  257.           After successfully completing the above steps, "Serial number
  258.           installation complete" will appear on the screen.  Your name
  259.           and unique serial number will then be encrypted in the program.
  260.  
  261.           To use this option, include -! on the PKZIP command line. When
  262.           you then extract or test a file using PKUNZIP, it will
  263.           automatically be verified for authenticity.  An example is
  264.           shown below.
  265.  
  266.           D:\> PKZIP -! ALL.ZIP *.*
  267.  
  268.           In this example, all of the files in the current directory
  269.           will be ZIPPED into a file called ALL.ZIP, and they will
  270.           include the Verify Authenticity option.  When this file is
  271.           UNZIPPED using PKUNZIP, a message will appear stating the
  272.           authenticity has been checked.
  273.  
  274.     NOTE: The authenticity verification feature is available in the
  275.       U.S.A. and Canada only.  File encryption and authenticity
  276.       verification is not available in export versions of the software.
  277.  
  278.  
  279.      PKWARE Version 1.1  Addendum         5
  280.  
  281.  
  282.  
  283.      PKUNZIP
  284.  
  285.      The following new features have been incorporated into the PKUNZIP
  286.      Version 1.1 software release.
  287.  
  288.  
  289.      -3  Disable 80386 instruction usage
  290.      -----------------------------------
  291.  
  292.           This option is available for users with 80386 type computers.
  293.           It is used to turn OFF the added 80386 instructions or
  294.           registers.  When these instructions are available, PKUNZIP
  295.           will utilize them to allow the program to function even
  296.           faster.  However, if you are running a different program that
  297.           may conflict with the use of the 80386 instructions, you can
  298.           disable them by using this command.
  299.  
  300.           The 80386 instructions will be disabled only for the current
  301.           PKUNZIP operation.  They will be enabled immediately after the
  302.           command operation is completed.
  303.  
  304.  
  305.           C:\PKWARE> PKUNZIP -3 COMP.ZIP  DAT*.*
  306.  
  307.           In the above example,  all of the DAT*.* files in the ZIP file
  308.           COMP.ZIP will be extracted.  The 80386 instructions will be
  309.           disabled while the command is being executed.
  310.  
  311.  
  312.           You can also disable the 80386 instructions when you start
  313.           PKUNZIP by using the PKNO386 environment variable.  To set the
  314.           environment variable, type PKNO386=xxxx, where "xxxx" is any
  315.           string you choose.  If the string PKNO386 is present in the
  316.           environment, then PKUNZIP will not use the 80386 instructions
  317.           or registers.
  318.  
  319.           To enable the 80386 instructions after they have been
  320.           disabled, type SET PKNO386=<Enter>, where <Enter> refers to
  321.           the Enter key.
  322.  
  323.           NOTE:  Disabling the 80386 usage will make PKUNZIP run up to
  324.                  forty percent slower than if the 80386 instructions are
  325.                  used.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      PKWARE Version 1.1  Addendum         6
  336.  
  337.  
  338.  
  339.      -^  Echo the command line
  340.      -------------------------
  341.  
  342.           This command is used to display the PKUNZIP command that you
  343.           entered on the console.  It is useful for example, when you are
  344.           using the View file option.  It allows the file specifications
  345.           that you entered to be echoed on the screen along with the
  346.           command output.
  347.  
  348.           E:\> PKUNZIP  -^ -vn  MAY.ZIP
  349.  
  350.           In this example, technical information about all of the files
  351.           included in the MAY.ZIP  ZIP file will be displayed.  The
  352.           information will be sorted by name in ascending order, and the
  353.           command line will be redisplayed on the screen above the
  354.           output.
  355.  
  356.  
  357.      -$   Restore volume label
  358.      -------------------------
  359.  
  360.           This command is used to restore any volume label that has been
  361.           stored in the ZIP file.  It is important to remember that the
  362.           PKZIP command used to save a volume label does not store a
  363.           drive letter along with the label.  Upon extraction, the
  364.           volume label will be assigned to the extract drive.
  365.  
  366.           C:\> PKUNZIP  stuff  -$ d:\misc
  367.  
  368.           In the above example, all of the files STUFF.ZIP will be
  369.           extracted to the D:\MISC\ directory, and the volume label for
  370.           drive D: will be reset to the one contained in STUFf.ZIP.
  371.  
  372.  
  373.      -f   Freshen files in extract directory
  374.      ---------------------------------------
  375.  
  376.           This function is the inverse of the Freshen option in PKZIP.
  377.           When this option is used, files will be extracted from the ZIP
  378.           file if and only if:
  379.  
  380.           a)  the files already exist in the target extract directory,
  381.           AND
  382.           b)  the files in the ZIP file are newer then the files in the
  383.               extract directory.
  384.  
  385.           D:\MISC> PKUNZIP -f  files.zip  a:
  386.  
  387.           In this example, only those files that meet both of the above
  388.           criteria will be extracted to the A: drive.
  389.  
  390.  
  391.      PKWARE Version 1.1  Addendum         7
  392.  
  393.  
  394.  
  395.      -x or -e[c,d,e,n,p,s]  Extract files in designated order
  396.      --------------------------------------------------------
  397.  
  398.           The above option is used to specify a particular order in
  399.           which to extract files from a ZIP file.  These options are
  400.           used along with  -x or -e, the default PKUNZIP extract option.
  401.           All of the options are defined below.
  402.  
  403.           -xc or -ec   Extract files in order of CRC value
  404.           -xd or -ed   Extract files in order of date
  405.           -xe or -ee   Extract files in alphabetical order by extension
  406.           -xn or -en   Extract files in alphabetical order by file name
  407.           -xp or -ep   Extract files in order of percentage (ratio) of
  408.                        compression
  409.           -xs or -es   Extract files in order by size
  410.  
  411.  
  412.           NOTE:  Future versions of PKUNZIP will only support the -e
  413.                  option and support of the -x option will be discontinued
  414.                  in future versions of PKUNZIP.
  415.  
  416.           C:\ZIPS>  PKUNZIP  -en -cm  keep.zip
  417.  
  418.           In this example, all of the files in KEEP.ZIP will be
  419.           extracted to the monitor in alphabetical order.
  420.  
  421.  
  422.      ZIP2EXE
  423.  
  424.           ZIP2EXE no longer requires external PKSFX.PRG files.  There are
  425.           new command line features available with version 1.1 of the
  426.           ZIP2EXE program.  The features available depend on whether you
  427.           are using the MS-DOS or OS/2 versions of the sofware.
  428.  
  429.           ZIP2EXE  MS-DOS version   -j    Use PKFSXjr program
  430.           ZIP2EXE  OS/2 version     -f    Use PKSFX family mode program
  431.  
  432.  
  433.           ZIP2EXE -j   Use the PKSFXjr program
  434.  
  435.           This option is available only if you have the MS-DOS software
  436.           version.  If the -j option is specified, the mini version,
  437.           PKSFXjr, will be used.  For details on this option, see the
  438.           section on PKSFXjr on page 10.  If this option is not
  439.           specified, the ZIP2EXE program will utilize the standard PKSFX
  440.           program.
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.      PKWARE Version 1.1  Addendum         8
  448.  
  449.  
  450.  
  451.           ZIP2EXE -f  Create family mode self-extracting file
  452.  
  453.           This option is used when you are using the OS/2 software
  454.           version.  It specifies that an OS/2 family mode .EXE file is to
  455.           be created, which will run under OS/2 and MS-DOS. If this
  456.           option is not included on the command line, the software will
  457.           create an OS/2 protected mode .EXE file.
  458.  
  459.  
  460.  
  461.      PKSFX  -s<password>   Support password decryption
  462.      -------------------------------------------------
  463.  
  464.           PKSFX now supports the -s<password> decryption option.  This
  465.           option functions the same as with the PKUNZIP option.  When
  466.           unzipping a ZIP file, including a self-extracting ZIP file,
  467.           that has been encrypted, the files cannot be extracted unless
  468.           the correct password is specified on the command line.
  469.  
  470.           When specifying the password, there is no space between the s
  471.           and the password.  Also, the password is case sensitive.
  472.           Recall, it is important that you remember or somehow record
  473.           the passwords that you use, because PKWARE does not retain a
  474.           record of these passwords anywhere.
  475.  
  476.           D:\> a:files -sCode b:
  477.  
  478.           In the above example, the self-extracting ZIP file, FILES.EXE,
  479.           will be extracted to the B: drive if the correct password for
  480.           the file is Code.
  481.  
  482.  
  483.  
  484.      PKSFX   Confirm before extracting files
  485.      ---------------------------------------
  486.  
  487.           If the ZIP comment for a file contains a Ctrl-S (0x13), PKSFX
  488.           will display the ZIP comment followed by this statement: "Do
  489.           you want to extract these files now (y/n)?"
  490.  
  491.           After viewing the ZIP comment, you can decide if you actually
  492.           want to extract these particular files.  Press Y to extract the
  493.           files.  Press N to abort the PKSFX process.  If the process is
  494.           aborted, PKSFX will exit with with an ErrorLevel of 12.
  495.  
  496.           The Ctrl-S character string will not be displayed in the ZIP
  497.           comment.
  498.  
  499.  
  500.  
  501.  
  502.  
  503.      PKWARE Version 1.1  Addendum         9
  504.  
  505.  
  506.  
  507.      PKSFXjr
  508.      -------
  509.  
  510.           This is a mini-PKSFX program.  You can create a self-
  511.           extracting ZIP file with it by using the -j option on the
  512.           command line when running the ZIP2EXE version 1.1 program.  An
  513.           example is shown below.
  514.  
  515.           C:\MISC> ZIP2EXE  -j  miscfile.zip
  516.  
  517.  
  518.           PKSFXjr includes the following features.
  519.  
  520.           - PKSFXjr is only 2936 bytes in size.
  521.  
  522.           - PKSFXjr also supports the comment pausing feature added to
  523.             the standard PKSFX program.  For details on this feature, see
  524.             the explanation above.
  525.  
  526.           - PKSFXjr will extract all of the files in the self-extracting
  527.             ZIP file.  Individual file names cannot be specified.
  528.  
  529.           - The only PKUNZIP command line option supported by PKSFXjr is
  530.             the  -o Overwrite option.
  531.  
  532.           - A maximum of approximately 500 files can be contained within
  533.             a PKSFXjr.EXE file.  However, there is no limit on the
  534.             overall size of the .EXE file that can be created with
  535.             PKSFXjr.
  536.  
  537.           - PKSFXjr only supports the Exploding of files.  Files that
  538.             have been compressed using the Shrinking method will not be
  539.             extracted.  In order to create a PKSFXjr.EXE file, the -ei
  540.             Implode only option of PKZIP must be used.
  541.  
  542.           - PKSFXjr requires only about 32K of memory to run.
  543.  
  544.           - PKSFXjr has the following ErrorLevel exit codes:
  545.  
  546.             1.  Warning error (failed CRC etc.)
  547.             2.  Can't find .EXE file
  548.             3.  Error in .EXE file
  549.             4.  File has a bad table
  550.             5.  Can't create file
  551.             6.  Disk full
  552.             7.  Too many files
  553.             8.  User aborted at comment pausing
  554.  
  555.  
  556.  
  557.  
  558.  
  559.      PKWARE Version 1.1  Addendum         10
  560.  
  561.